Attempts to add the specified item to any one of the specified
BlockingCollection<(Of <(T>)>) instances.
Namespace:
System.Collections.Concurrent
Assembly:
System.Threading (in System.Threading.dll)
Syntax
| Visual Basic (Declaration) |
|---|
Public Shared Function TryAddToAny ( _
collections As BlockingCollection(Of T)(), _
item As T, _
timeout As TimeSpan _
) As Integer |
| C# |
|---|
public static int TryAddToAny(
BlockingCollection<T>[] collections,
T item,
TimeSpan timeout
) |
Parameters
- collections
- Type: array<
System.Collections.Concurrent..::.BlockingCollection<(Of <(T>)>)
>[]()[]
The array of collections.
- item
- Type: T
The item to be added to one of the collections.
- timeout
- Type: System..::.TimeSpan
A TimeSpan that represents the number of milliseconds
to wait, or a TimeSpan that represents -1 milliseconds to wait indefinitely.
Return Value
The index of the collection in the
collections
array to which the item was added, or -1 if the item could not be added.
Exceptions
| Exception | Condition |
|---|
| System..::.ArgumentNullException | The collections argument is
null. |
| System..::.ArgumentException | The collections argument is
a 0-length array or contains a null element, or at least one of collections has been
marked as complete for adding. |
| System..::.ObjectDisposedException | At least one of the BlockingCollection<(Of <(T>)>) instances has been disposed. |
| System..::.ArgumentOutOfRangeException | timeout is a negative number
other than -1 milliseconds, which represents an infinite time-out -or- timeout is greater than
MaxValue. |
| System..::.InvalidOperationException | At least one underlying collection didn't accept the item. |
| System..::.ArgumentOutOfRangeException | The count of collections is greater than the maximum size of
62 for STA and 63 for MTA. |
See Also
